Power Utilities

home *** CD-ROM | disk | FTP | other *** search

/ Power Utilities / Power Utilities.iso / ek / jadu200 / jadu.doc < prev next >

Wrap

Text File | 1990-10-30 | 77.7 KB | 2,443 lines

J A D U (Just Another Directory Utility) Version 2.0 September, 1990 J.C. Ratjen 532 Logan Avenue New York, NY 10465 (212)823-1050 CIS# 75006,2277 _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Copyright (c) 1988-1990 by J.C. Ratjen All rights reserved. ---------------------------------------------------------------------- T A B L E O F C O N T E N T S ---------------------------------------------------------------------- Introduction...............................................1 Starting JADU..............................................3 Installation...........................................3 Syntax.................................................4 Some examples..........................................4 The Display................................................6 Status area............................................6 Directory tree.........................................6 File list..............................................7 Movement/Action keys.......................................9 Backslash..............................................9 Left/Right Arrows......................................9 Up/Down Arrows.........................................9 Home/End...............................................9 PgUp/PgDn..............................................9 Keypad plus............................................9 Keypad minus...........................................9 Enter.................................................10 Space.................................................10 Scroll lock...........................................10 <F3>..................................................10 Commands..................................................11 Archive functions.....................................11 Copy..................................................11 Create Directory......................................12 Date/Time functions...................................12 Delete................................................12 DOS Commands..........................................13 Edit..................................................13 'Execute'.............................................13 Exit..................................................13 Changing File Attributes..............................14 Find File.............................................14 Format................................................14 Help..................................................14 List/View.............................................14 Move..................................................15 New Path/Mask.........................................15 Print.................................................15 Rename................................................16 Refresh screen........................................16 Sort..................................................16 Tag activation........................................16 Update................................................17 Wildcard Tag..........................................17 DESQview and JADU.........................................18 Appendix A - The Install program..........................19 Appendix B - Configuration file specs.....................23 Appendix C - Revision History.............................27 ---------------------------------------------------------------------- I N T R O D U C T I O N ---------------------------------------------------------------------- Hello! Thanks for trying JADU. I hope you find it as useful and easy to use as I have. You see, that's the whole concept behind JADU - simplicity and ease of use. I started JADU after becoming frustrated by other directory utilities, by their heavy use of function keys and mnemonics that were strained - to say the least. They also wouldn't let me use the utilities I'd become so dependent upon. Thus was JADU born. It was designed from the beginning to be a utility where the commands made sense (want to delete a file? Hit <Delete>. Want to delete a directory? Hit <Delete> for that too, not Alternate-F5 or some other nonsense). I also bore in mind that everyone has their favorite utilities and would probably want to use them without having to jump out to DOS to invoke them at the command line. JADU knows about archive utilities, editors, file viewers, file finders, as well as print and format utilities, and it doesn't limit you to any specific utility. You tell IT what utility YOU want to use. JADU also lets you specify actions you might want taken based on the file's extension AND its directory (a much more potent combination than just the extension alone). As most of you probably suspect by now, JADU is USER SUPPORTED SOFTWARE. For those of you new to the Wonderful World of BBS's, User Supported Software means that you are allowed to try JADU before purchasing it to see if it's what you're looking for. If you decide JADU isn't for you, so be it. If, on the other hand, you like JADU and continue to use it you are obliged to register. (Corporate and government users MUST register - call for special terms). Registration costs only $25 and brings with it telephone support, the latest version of JADU, notice of upgrades (plus a discount on those upgrades), a copy of the documentation and a clear conscience. See REGISTER.FRM for more information. Whether you register or not, I encourage you to spread JADU far and wide. Please pass it along in its original archived form. You MAY NOT sell JADU! If JADU is distributed on diskette, you may charge up to eight dollars for materials, shipping, and handling, but no other fees may be collected. Many people have used JADU and found it to be just what they needed. However, it is solely *YOUR* responsibility to determine the fitness of this package to meet your needs. I will not be liable for damages of any kind arising from a failure of JADU to perform as expected. Page 1 I would like to take this opportunity to thank all of the people that have contributed to the development of JADU. This is by no means a complete list, and I apologize to those I've forgotten. Ron Abernethy, Joe Apuzzo, Ed Bauman, Frank Corlett, Steven Dubin, Pete Lembeck, Bill Leyser, Ron Maffei, David Marcus (who gave above and beyond the call of duty), Jack Pearson, Fred Villani, all of the folks at EMS, and, above all, my loving wife Camille. Page 2 ---------------------------------------------------------------------- S T A R T I N G J A D U ---------------------------------------------------------------------- Installation Starting JADU is pretty easy. If you're in a hurry you can just rename the sample configuration file to JADU.CNF and type JADU (the sample file has been configured with some of the more popular shareware utilities - PKZIP, PKUNZIP, LIST, and QEDIT). The real power of JADU though is gained through the use of the JADUINST program. Use it to let JADU know what utilities YOU want to use. JADU uses the configuration file not only to determine what utilities you want to use, but also to learn your choices for such things as screen colors, sorting order, and mouse speed (yes, JADU likes mice). Without the configuration file, JADU will still operate, although without the grace of the non- lobotomized version. The configuration file must be named JADU.CNF and, along with JADU.EXE, reside either within the current directory or in a directory pointed to by the PATH environmental variable. For example, if you had the following line in AUTOEXEC.BAT, PATH=C:\;C:\DOS;C:\UTILITY you could place the files in the root directory, C:\DOS or C:\UTILITY. (Personally, I'd choose C:\UTILITY.) See Appendices A & B for more information on the installation program and the configuration file. There is an optional environmental variable that you may want to use. In order to speed startup, JADU can store the directory tree in a file called JADUDIRx.JDU, where x is the drive letter (C for drive C, etc.). Once this file is created JADU will read the tree information from it rather than scan the drive each time it starts. It will only do this if you define the variable JADUDIR to point to the directory JADU should use to store this file. For example, if you have the following line in AUTOEXEC.BAT: SET JADUDIR=D:\ JADU will save the tree information in the root directory on the D drive. If this variable was not set, JADU would scan the drive normally. Use of this option can greatly decrease the amount of time it takes JADU to start up. Unfortunately, it can also lead to great confusion if you are not careful. Keep in mind that if you create a directory outside of JADU the file WILL NOT REFLECT THIS CHANGE. If you find that this has happened, or you do not see a directory you think should exist, use the pdate command to refresh the file. Page 3 You can minimize the possibility of this happening by storing the file in a RAM disk or by modifying AUTOEXEC.BAT to delete the files on startup. Either of these will cause JADU to start the 'day' with an up to date file. (As of version 1.3 JADU checks all directories found while loading the files area against those in the directory tree and updates the tree if necessary, thus reducing the chances of 'phantom' directories). Syntax The command line syntax is: JADU [switches] [file selection mask] Switches are prefaced with either a dash or a slash and can be combined (see the examples below). Switches are not case sensitive. The valid options are: /B - Force BIOS reads and writes. Normally JADU will write directly to the screen memory (unless you're using DESQview). This can cause problems in some not-too-compatible machines, hence this switch. You can set this option permanently in the 'Preferences' section of the install program. /M - Force monochrome. Some machines, especially laptops, cause JADU to think they're capable of displaying colors when they really aren't. This switch tells JADU to map all colors to monochrome equivalents. /L## - Number of lines on the screen. Valid sizes range from 10-25 lines. In addition, EGA users can specify 43 lines and VGA users 50 lines. You can set this option permanently in the 'Preferences' section of the install program. Please note that because the help screens are a fixed size they will not display if you set this to less than 25 lines. The file selection mask allows you to specify what files JADU is to display. It accepts different drives and paths, as well as wildcards. This works the same as the <N>ew path command described in the commands section of this document. The default file selection mask is '*.*'. Some examples JADU Starts JADU in the current directory and displays all files (the default mask is '*.*', remember?). Page 4 JADU D: Starts JADU on the D: drive and display all files. JADU *.DOC Starts JADU in the current directory and displays only those files having an extension of '.DOC'. JADU /ML50 Starts JADU in the current directory, displays all files, forces monochrome mode, and displays 50 lines on the screen (remember, you must have a VGA display to view this many lines). JADU /M /L50 *.* Exactly the same as the last example. JADU /BML16 D:\UTILITY\*.EXE Forces JADU to use BIOS calls, display mono, and sets the screen size to 16 lines. Also, JADU will start in the UTILITY directory on the D: drive and only display .EXE files (whew!). Page 5 ---------------------------------------------------------------------- T H E D I S P L A Y ---------------------------------------------------------------------- JADU's display is divided into three distinct sections - Status area (top), Directory tree (left), and File list (right). Allow me to discuss each in detail... Status area The Status Area displays information about the current drive, directory and file (among other things). The top line displays the name of the current directory and the file selection mask. The current directory is pretty straight forward, but the idea of a selection mask may be new to some of you. The selection mask allows you to specify what files will appear in the file list. Normally the mask is set to '*.*' meaning "show all files", but it can be easily changed (with the <N>ew Path/Mask command) to the mask of your choice. For example, if you set the mask to '*.DOC' JADU will display only those files with an extension of '.DOC'. The remaining items in the status area are as follows: Total: the total capacity of the current drive, in bytes Free: the total number of unused bytes remaining on the current drive Used: the total number of bytes already used on the current drive Files: the total number of files in the current directory (not counting subdirectories or the volume label). Dir size: the total number of bytes used by the files in the current directory File size: the size of the current file, in bytes Directory tree The Directory Tree is a visual representation of all of the directories on the current drive. Each sub-directory is shown below, and indented to the right of its parent. As with all good things there are limits associated with the directory tree. First of all, only the first 150 directories will show on the tree. This should suffice in most cases (if the demand is there, I might be persuaded to increase the limit). Page 6 Second, there is a limit of seven levels to any given directory. For example, \a\b\c\d\e\f\g is valid, as far as JADU is concerned, but \a\b\c\d\e\f\g\h is not (8 levels). The current directory is displayed in reverse. To change directories, simply use the movement keys (see below) to move the pointer to the desired directory and hit <Enter> or point to the directory with the mouse and press both buttons. File list All files in the current directory that match the file selection mask are displayed in the File list window, along with information about those files. They are displayed sorted according to the criteria you specify (either in the configuration file or with the <S>ort command). Up to 500 files can be listed in this area. The information displayed is as follows: File name: The file name is pretty self explanatory. Remember that only those files matching the file selection mask will be displayed. File size: The file size is shown ROUNDED TO THE NEAREST K (i.e. 1024 bytes). It is followed by an uppercase 'K' to remind you of this fact. The sole exception to this is files that would normally be rounded to 0K. They are shown as being 1K so as not to be confused with empty files. If you need to know the exact size, move the pointer to the file and check the 'File size' in the Status Area. If the file listed is actually a directory or the volume name, JADU will place <dir> or <vol> in place of the size. Attributes: Each file has several 'attributes' that can be manipulated by JADU. These are displayed after the file size. If the attribute is 'on' the corresponding letter will be displayed, otherwise a dot will be shown. The attributes are: Archive displayed as a lowercase 'a'. This attribute is used by backup utilities to determine if a file has changed since the last time it was backed up. If the attribute is off the file hasn't changed. If it's on, the file has changed and should be backed up. Hidden displayed as a lowercase 'h'. If this attribute is on the file will not be seen by normal DOS commands (such as DIR). Read Only displayed as a lowercase 'r'. If on, prevents the file from being deleted or changed by any DOS operation. Page 7 System displayed as a lowercase 's'. This is a a holdover from CP/M. It will hide files like the Hidden attribute, but serves no real purpose under MSDOS. Date & time stamp: After the file attributes, JADU displays the date and time that the file was last modified. The time is shown in 24 hour format. Page 8 ---------------------------------------------------------------------- M O V E M E N T / A C T I O N K E Y S ---------------------------------------------------------------------- Backslash The backslash will move you into the root directory on the current drive. It is the same as if you had pressed <Enter> while on the top item (the root directory) in the directory tree. Left/Right arrows The left and right arrow keys allow you to alternate between the Directory Tree and File list areas. The active area will contain the pointers and have a double line as its top window border. Up/Down arrows The up and down arrow keys perform as you would expect - they move the pointer up or down by one file or directory. If you are using a mouse you can move up/down one file/directory by clicking the left button on the top/bottom window border. Home/End These keys will move the pointer to the top (or bottom) of the current 'page' of files or directories. A second press of the same key will move to the first (or last) file or directory in the list. If the pointer is already at the top (or bottom) of the page, you will only have to hit the key once to go to the first or last file. If you are using a mouse you can move to the first or last file/directory in the list by clicking both buttons in the top/bottom window border. PgUp/PgDn Move the pointer up and down by one 'page' (19 lines). If you are using a mouse you can page up/down by clicking the right button on the top/bottom window border. Keypad plus 'Tags' the file at the pointer position. You can perform a given action on many files if you tag them first. If you are using a mouse you can tag a file by pointing to it and clicking the left button. You can quickly tag all of the files in a subdirectory by tagging the '<current>' entry in the File list area or the highlighted directory in the Directory tree area. If you are one of those people hooked on function keys you can also use <F5> to tag all files. Keypad minus 'Untags' the file at the pointer position. If you are using a mouse you can untag a file by pointing to it and clicking the right button. Page 9 You can quickly untag all of the files in a subdirectory by untagging the '<current>' entry in the File list area or the highlighted directory in the Directory tree area. <F6> will also untag all files. Enter The <Enter> key has two functions. First it allows you to enter a directory by pointing to it and pressing <Enter>. Second, if you point to a file other than a directory JADU will execute the command (if any) that you have defined for the file, based upon the file's extension and the current directory (see 'Execute' in the DOS commands section). If you are using a mouse the same functions can be accomplished by pointing to the file/directory and clicking both buttons. Space Toggles the tag on the current file (i.e. if it's tagged you'll untag it and vice versa). NOTE See the explanation of the <T>agged command to learn how to use the tag option. Scroll Lock Scroll Lock will cause JADU to automatically move the pointer down one line when you tag or untag a file, thus saving you a keystroke. (You can tell JADU to automatically activate Scroll Lock on program startup in the configuration file). <F3> <F3> will recall your last response to a given prompt. Response recall is command specific - that is it recalls the last answer you gave for that command. For example, if you press <F3> while at the Copy prompt you'll recall the last copy destination, even if you've answered a number of other prompts since that time. <F3> only works within the current session. Commands are not 'remembered' after you exit JADU. Page 10 ---------------------------------------------------------------------- C O M M A N D S ---------------------------------------------------------------------- Archive Functions Pressing 'A' will cause JADU to display a submenu of Archive functions. These options are: Add: Option 'A' on the submenu. This will allow you to add a file (or several files, if the tag option is active) to an archive. You will be prompted for the name of the archive. Extract: Option 'E' on the submenu. This causes all files in the target archive(s) to be extracted. You will be prompted for the destination directory (you can use the arrow keys to point to the destination on the directory tree). Move: Option 'M' on the submenu. This will allow you to move a file (or several files, if the tag option is active) into an archive. This is functionally the same as 'Adding' the file(s) then deleting them. You will be prompted for the name of the archive. View: Option 'V' on the submenu. All of the files in the target archive(s) will be listed. A hint: If you find yourself using the 'V' or 'E' options a lot you can save time by utilizing a user defined function. For example, you could make JADU list all of the files in an archive by telling it to invoke PKZIP with the 'V' option whenever the <Enter> key is pressed on a file with a '.ZIP' extension. Please note that these functions will not operate unless you specify what Archive utilities to use in the configuration file. Copy The copy command is pretty straight forward. Press 'C' and JADU will prompt you for the destination. If you are copying more than one file you can only enter the path or a wildcard filename as the destination. If you are copying a single file you may enter a specific filename. As a quicker means of path entry, JADU allows you to use the arrow keys to point to the destination on the directory tree. If the file exists you will be prompted to confirm the copy before the old file is overwritten. If you are copying several files when this happens you will notice that besides the usual Y/N choices you also have 'G'. The 'G' stands for "Go To It". Press it and JADU will copy the rest of the files without prompting for confirmation if any of them already exist. Page 11 Create Directory You can easily create a directory by pressing <Insert>. If you are in the File List area the directory created will be a subdirectory of the current directory. If you are in the Directory Tree area you will create a subdirectory of the directory at the pointer location. Date/Time functions Displaying the Current Date and Time: Pressing <Alt-T> will toggle the displaying of the current date and time on the bottom line of the screen. This information will be constantly updated. You can have JADU start either with or without this display (it's a configuration option, see Appendices A & B). Changing a File's Date: Pressing <F9> will prompt you for a new date for the target file(s). If you are using a mouse, just click either button on the date and you'll be prompted for the new date. Changing a File's Time: Press <F10> to change the file(s) time stamp. If you are using a mouse, just click either button on the time and you'll be prompted for the new time. Touching a File: Press <F4> to set the file(s) date and time stamps to the current date and time. Your system clock must be set correctly for this command to work. (I realize that these keys don't even come close to being mnemonics for the commands, but all of the good letters were already taken. I'll listen to any suggestions...). Delete Files and directories can be deleted by pressing 'D' or <Delete>. You'll be prompted for confirmation before the deletion will take place. One note - unlike files, directories cannot be tagged and deleted. This was done on purpose as a safety measure (it's not a bug, it's a feature). Unlike DOS, JADU allows you to delete the current directory. It simply moves you to the parent before the deletion (why can't DOS do that?). Page 12 DOS Commands There are two methods you may use to execute DOS commands in JADU: Internal Command: Pressing '>' will cause JADU to open a window and prompt you to enter a DOS command. The screen will then clear and the command will be executed as if you had typed it at the DOS prompt. When the command is completed you will be prompted to hit a key before returning to JADU. This command is easier to remember than it may at first appear if you keep in mind that DOS terminates its normal prompt with the angle bracket. Jump to DOS: If you have more than one DOS command that you want to execute you might want to temporarily <J>ump to DOS. This will create a DOS shell in which you can enter commands as if you were at the normal DOS prompt. When you are through simply type 'EXIT' to return to JADU. NOTE: It's easy to forget that you are in JADU's shell rather that at the regular DOS prompt. If you are unsure which is the case just type 'EXIT' (there's no effect if you are at the regular prompt). Alternately you can try to run JADU (it knows when it's running already and will tell you). Edit Press 'E' to edit the target file(s). Please note that Edit will not operate unless you specify what editor JADU should use in the configuration file. 'Execute' Pressing <Enter> while on a file will 'execute' a user-defined action based upon the file's extension and the current directory (point to the file and click both buttons on the mouse to accomplish the same thing). These actions are specified in the configuration file and can be entered or changed with the install utility. See Appendices A and B for more information on the configuration file. Exiting the Program You can exit JADU by one of two methods. Pressing either 'X' or <Esc> will exit the program and return you to the directory in which JADU was started. Pressing 'Q' will 'quit' the program and remain in the current directory. Page 13 File Attributes, changing The file attributes can be toggled using the 1,2,3, & 4 keys. The numbers directly correspond to the 'ahrs' in the File list display. For example, pressing '1' will toggle the Archive attribute, pressing '2' will toggle Hidden, etc. (the keys may not be mnemonics, but they should be easy to remember.) Find File If you are looking for a particular file, but don't know where it is located you can use JADU's file find capabilities. Press 'F' and you will be prompted for the name of the file you want to find. If you specified an external utility to use for this purpose JADU will invoke it and pause before returning to the main program. If you did not, JADU will use an internal routine to search all directories on the current drive for the file. The internal file finder will notify you if it finds what you are looking for, and give you the option of going to the file. If you answer 'Y'es JADU will change directories and move the pointer to the file. Specifying 'N'o will continue the search. 'Q'uit ends the search. Format Disk If you press <F8> JADU will format a disk for you. You will be prompted to enter the letter of the disk you want to format. Please note that this command will not work unless a formatting utility is specified in the configuration file. Help Pressing 'H', '?', or <F1> within JADU will display a help screen containing a summary of the commands. If you are using a mouse you can obtain help on the mouse commands by hitting the space bar while the main help screen is displayed. Additional information pertaining to your version of JADU can be obtained by pressing 'I' (outside of Help). Non-registered versions of JADU will display a copyright notice, version number and information on how to register. Registered users will see their name and address in place if the registration information. List/View Pressing either 'L' or 'V' will invoke the File View program you specified in the configuration file to look at the current file (or files if the tag option is active). If you didn't indicate which program to use, JADU will complain and the command won't work. Page 14 Move You can move a file from one directory or drive to another by pressing 'M'. Move has the same restrictions regarding destination names as the Copy command. Also like Copy, you can use the arrow keys to indicate the destination path on the directory tree. Normally files are moved by simply changing their name. If you are moving the file(s) to a different drive, or you are using DOS 2.x, move works a little differently. In these cases a quick rename will not work. JADU knows this and will compensate by first copying the file to the destination and then deleting the original. The result is the same, just a bit slower. New Path/Mask You can specify a new path or file selection mask by pressing 'N'. You will be prompted for the new path/mask. For example, if you want to see all of the '.COM' files in your UTILITY directory you could enter 'C:\UTILITY\*.COM'. You can also use this command to change drives. One quick warning - it's easy to forget that you've changed the mask. If you don't see as many files as you believe there should be, check the file selection mask. It's more than likely the cause. Print Pressing 'P' will display the Print options submenu. Items on the submenu are as follows: File(s): Option 'F' on the submenu. This will invoke the print utility of your choice to print the current file (or files if the tag option is active). Please note that if you chose to use DOS Print there is, unfortunately, a price to pay. DOS Print allows a maximum of ten files to be in queue at any given time. If you have tagged more than the limit only the first ten will be printed. Directory: Option 'D' on the submenu. This will cause JADU to print a list of the files in the current directory in the same format as the File list area. Tree: Option 'T' on the submenu. Pressing this will make JADU print the directory tree. Your printer must be capable of printing line graphics. Page 15 Rename Pressing 'R' will allow you to rename a file or directory (you must have DOS 3.x to rename a directory). You can rename multiple files at one time by first tagging them and then using a filename containing wildcards for the new name. Refresh screen Pressing <F7> will refresh the screen. This is useful if you get the DOS 'Insert disk for drive x' message. (If anyone knows how to trap this message please drop me a line.) Sort Pressing 'S' will display the Sort option submenu. Items on the submenu are: Date: Option 'D' on the submenu. This will cause the File list to be sorted according to the file's date/time stamp. The most recent files will be displayed first. Extension: Option 'E' on the submenu. Files will be sorted in alphabetical order based upon the file's extension. In the case of duplicate extensions the file name will be used as a tie-breaker. Name: Option 'N' on the submenu. Files will be sorted in alphabetical order based on the full file name. Size: Option 'S' on the submenu. Files will be sorted in size order, from largest to smallest. Tagged: Option 'T' on the submenu. This behaves the same as the <N>ame option with the exception that tagged files are moved to the top of the File list. Unsorted: Option 'U' on the submenu. Files are shown in the same order as if you used the DOS DIR command. When you first use this option JADU will reload the file list to determine the proper order. Tag active Pressing 'T' or <F2> activates the tag option. This informs JADU that you wish to perform the next command on all of the tagged files. If the next command does not accept tagged files the option is turned off. Page 16 If you set the 'Tag on by default' choice to 'On' during installation the above becomes reversed. In this case Tag becomes active the minute you tag a file and the 'T' command (or <F2>) turns *OFF* the tag option. An alternative to pressing 'T' before a command is to hold down the <ALT> key while pressing the command. For example, pressing <ALT>-C is functionally equivalent to pressing 'T', then pressing 'C'. Update Pressing 'U' updates JADU's directory and file information. It accomplishes this by performing a full reload based on the current path. This is most useful when JADU is displaying floppy-based information and you wish to change diskettes. After placing the new floppy in the drive, hit 'U' and the old information will be replaced. This command can also be used to update the drive's directory save file (if you defined JADUDIR - see 'Starting JADU'). The pdate command does not read tree information from the save file, rather it scans the disk and recreates the file. In this way you can correct a save file that has gone 'out of synch' with reality (usually caused by creating directories outside of JADU). Wildcard Tag Many files can be tagged at one time by pressing 'W'. JADU will then prompt you for a wildcard specification and tag all of those files in the current directory that match it. For example, specifying '*.DOC' will tag all files with an extension of '.DOC'. While programming JADU I noticed that most people use the wildcard tag feature to tag files based upon the file extension. As a result I placed a shortcut in JADU that allows you to hit the asterisk to invoke wildcard tag. Unlike hitting 'W' this will prime the wildcard specification with a leading '*'. For example, if you want to tag all files ending with '.BAK' you don't have to type 'W' then enter '*.BAK' at the prompt. You can simply type '*.BAK'. This is a lot easier to use than it is to describe. Try it. I think you'll like it. Page 17 ---------------------------------------------------------------------- D E S Q v i e w A N D J A D U ---------------------------------------------------------------------- As of version 2.0 JADU is DESQview aware. That means that those of you that use this great multi-tasking environment can use JADU without worrying about direct writes to the screen (among other things). A PIF file is supplied with JADU. Use this as the starting point for your own information file. The PIF file is based upon the following assumptions: - JADU resides somewhere in your PATH - The keys 'JA' will be used to start JADU - You are not running graphics programs from within JADU - JADU will start in a full-size window. Only 300K has been set aside for JADU's use. If you plan on running large programs from within JADU you'll probably have to increase this number. Installing the PIF file: Install the PIF as follows. (Please note that these steps are valid for version 2.25 of DESQview. If you are using a different version you may have to refer to your documentation). 1) Copy JA-PIF.DVP to your DESQview directory. 2) Start DESQview 3) Choose <O>pen, then <A>dd rogram 4) Choose <O>ther 5) At the Path prompt type the name of the directory to which you copied JA-PIF.DVP (probably \DV) 6) JADU should appear, along with whatever other program you have information file for in that directory. Use the arrow keys to move the selection bar to JADU, then press the space bar to mark it. 7) Choose 'DONE' (or press <Enter>). 8) Choose 'DONE' again (or press <Enter>). That should do it. At this point you should still be at the <O>pen menu. Typing 'JA' should start JADU. Page 18 APPENDIX A Using the Installation Program (JADUINST.EXE) Page 19 Use of the installation program is the key to getting the most out of JADU. With it you customize JADU to fit the way you work and to know what 'tools' you want to use. The command line syntax is: JADUINST [switches] Switches are prefaced with either a dash or a slash and can be combined (see the examples in 'Starting JADU' above). Switches are not case sensitive. The valid options are: /B - Force BIOS reads and writes. Normally JADUINST will write directly to the screen memory (unless you're using DESQview). This can cause problems in some not- too-compatible machines, hence this switch. /M - Force monochrome. Some machines, especially laptops, cause JADUINST to think they're capable of displaying colors when they really aren't. This switch tells JADUINST to map all colors to monochrome equivalents. Once you start the program a menu will appear. Make your choices by moving the selection bar with the arrow keys and pressing <Enter> (or you could press the capitalized letter). The Main Menu choices are described below. Screen colors: Press 'S' to bring up a mock-up of JADU's screen and a menu of the screen areas that can be modified. Use the arrow keys (or capital letter) to choose the area you want to change. The menu will disappear and you can then use the up and down arrows to change the background color and the left and right arrows to change the foreground color. Press <Enter> or <Esc> when you are satisfied and you'll return to the areas menu. Press <Esc> from there to return to the main menu. Preferences: Press 'P' to bring up the preferences menu. This menu allows you to change JADU's default method of operation in many key areas. Use the arrow keys to choose the option you wish to change. As you highlight each option a description of the item will appear in the 'Explanation' window. All but two options allow you to press <Enter> to cycle through the permissible values. Pressing <Enter> on the 'Screen size' option will cause you to be prompted for the screen size. If you are using the mouse, the 'Mouse speed' option allows you to use the arrow keys to change the horizontal and vertical speed of the mouse while moving the cursor on the screen to test the 'feel'. Page 20 Utilities: Press 'U' to display a menu of utilities. Beside each program is the current command line used to invoke the utility. To change the command either move the selection bar to the utility and press <Enter>, or press the capitalized letter. Once you make your choice a new screen will appear with several questions about the utility. Move the selection bar to the information you want to change and press <Enter>. As you highlight each option a description of the item will appear in the 'Explanation' window. user Commands: Press 'C' to add, delete, or modify user defined commands. These commands allow you to specify what action JADU should take when you press <Enter> while pointing to a file. The action is based upon the file's extension and, optionally, the current directory. Press <Ins> to add a new command. To delete a command just highlight it and press <Del>. To modify an existing command press <Enter> after highlighting it. The submenu is very similar to the one used for the utilities section. One area that could use a bit more an explanation than could possibly fit in the 'Explanation' box is the use of macros to describe the target file in the command line. The macro consists of a pair of curly braces containing any combination of five codes. The codes are as follows: D - Drive letter + colon E - File extension (without the dot) F - Full file name (name.ext, no path) N - File name only, no extension P - Full path, no drive letter, always terminated with a backslash Anything else is treated as a literal character and is inserted as is. The following are some examples, assuming that the full file specification is C:\UTILITY\TEST.DOC {D} = C: {P} = \UTILITY\ {F} = TEST.DOC {DPF} = C:\UTILITY\TEST.DOC {NE} = TESTDOC {N.E} = TEST.DOC (note that the dot was specified within the braces and was inserted in the final product as a literal character). Write file: Press 'W' to write all of your changes to JADU.CNF. As a reminder that you should use this option a check will appear next to it when any changes have been made to the configuration file. The check will disappear after the file is written. Page 21 eXit install: Press 'X' (or <Esc>) to exit the installation program. If you have made changes to the configuration file you will be given a chance to save the file prior to leaving the program. Page 22 APPENDIX B Configuration File Specifications The configuration file is simply a bunch of parameters that JADU needs to know before it can operate to its full potential. It must be named JADU.CNF and reside in the current directory or in a directory pointed to by the PATH environmental variable. Most people will not need the following specifications - the install program should be enough. For those of you who want a bit more control, here 'ya go... Page 23 ---------------------------------------------------------------------- D A T A S T R U C T U R E S ---------------------------------------------------------------------- /* Signature block */ struct sig_t { char name[4], /* Should always be 'JADU' */ vermaj, /* Major version number */ vermin, /* Minor version number */ fill[4]; /* Reserved for future use */ }; /* Colors */ struct color_t { unsigned char curdir, /* Current directory */ dirbnr, /* Directory banner */ help, /* Help screens */ hilite, /* General highlight */ info, /* Informational msgs */ keystatus, /* Shift/Numlock status */ norm, /* Normal screen */ pointer, /* File pointers */ tag, /* Tagged files */ time; /* Time display */ }; /* User preferences */ struct pref_t { char bios, /* Use BIOS reads/writes 0=No, 1=Yes */ doswait, /* Pause after DOS cmds 0=No, 1=Yes */ flicker, /* Flicker prevention 0=No, 1=Yes */ mhor, /* Horizontal mouse speed (1-99) */ mouse, /* 0=no mouse or don't use, 1=use mouse */ mvert, /* Vertical mouse speed (1-99) */ num, /* NumLock: 0=off, 1=on, 2=remains as is */ numlines, /* Screen length (10-25, 43,50) */ quitbnr, /* Display exit banner? 0=no, 1=yes */ scroll, /* Scroll Lock: 0=off, 1=on, 2=as is */ skey, /* Sort key: 0=D,1=E,2=N,3=S,4=T,5=U */ startside, /* Startup side 0=left, 1=right */ tagon, /* Tag on by default 0=No, 1=Yes */ time; /* Display time? 0=No, 1=Yes */ }; Page 24 /* ** Utilities ** ** Repeated 9 times to define the following utilities ** (in the order given): ** ** Archiver ** deArchiver ** Archive move ** Archive list ** Editor ** File viewer ** File finder ** Print utility ** Format utility */ struct util_t { char reread, /* Reread type on return: */ /* 0=None, 1=Full, 2=Target only */ prompt, /* Prompt before return? 0=No,1=Yes */ multi, /* Mult. files allowed? 0=No,1=Yes */ cmd[41], /* Command */ cmdt[41]; /* Command tail */ }; /* ** User-defined commands ** ** Repeated as many times as there are user-defined commands ** to a maximum of 20 times. */ struct exec_t { char reread, /* Reread type on return: */ /* 0=None, 1=Full, 2=Target only */ prompt, /* Prompt before return? 0=No,1=Yes */ ext[4], /* File extension */ dir[46], /* Directory */ command[46]; /* The actual command */ }; Page 25 Sample program: Assumes the above structures are defined in a header file called JADUDEF.H. #include <stdio.h> #include <jadudef.h> main() { FILE *fpcnf; int cnt, numexecs; struct sig_t sig; struct pref_t pref; struct color_t colors; struct util_t util[9]; struct exec_t exec[20]; fpcnf = fopen("jadu.cnf","r"); if (fpcnf == NULL) { puts("Unable to open configuration file."); exit(1); } fread(&sig, sizeof(struct sig_t), 1, fpcnf); if (strncmp(sig.name, "JADU", 4)) { puts("Configuration file bad."); exit(1); } fread(&colors, sizeof(struct color_t), 1, fpcnf); fread(&pref, sizeof(struct pref_t), 1, fpcnf); fread(util, sizeof(struct util_t), 9, fpcnf); numexecs = fread(exec, sizeof(struct exec_t), 20, fpcnf); fclose(fpcnf); for (cnt=0; cnt<9; cnt++) printf("Utility #%d: %s\n", cnt, util[cnt].cmd); for (cnt=0; cnt<numexecs; cnt++) printf("User cmd #%d: %s\n", cnt, exec[cnt].command); } Page 26 APPENDIX C Revision History Page 27 ---------------------------------------------------------------------- V E R S I O N 2 . 0 ---------------------------------------------------------------------- -> JADU is now DESQview compatible -> the attributes display has been changed to show the attribute letter if it is set, otherwise a dot is displayed. This makes it a lot easier to see set attributes on most laptops. -> Added nsorted option to sort menu -> Added <M>ove option to archive menu (that is, you can now move files into an archive - no more Arc Add, then Delete) -> Fixed a bug that caused odd directories to be created -> Fixed a bug that caused the screen to fall apart on older PC's and PC's using an AMI BIOS. -> Added command line switches: /M forces monochrome. /B Forces JADU to use BIOS reads/writes. /L## Sets the screen size to ## lines long. Default is 25 lines. Valid numbers are 10-25, plus 43 on EGA screens and 50 on VGA screens. -> The configuration file has a completely new format (binary). -> JADU is now more configurable. Among the new options are: - much more color control. - the ability to use BIOS read/writes - TAG ACTIVE by default. Normally you tell JADU to perform a command on a group of tagged files by pressing 'T' beforehand (or using the ALT key). With this option the extra keystroke is unnecessary. If you tag files and press a command JADU will perform it on the tagged files by default. If you are using this option the 'T' and ALT keys have the reverse effect - they turn *off* "TAG ACTIVE" for the next keystroke. THIS IS A VERY POWERFUL OPTION. USE IT WITH CARE. - specification of start side. You can tell JADU to begin on the left side (directory tree). - Quit banner on/off. You can now disable the "<<< You are currently in... >>>" display after you <Q>uit. This is for folks that have their DOS prompt set up to display this information already. - pause after DOS commands can be turned on/off Page 28 -> The install program has been completely rewritten. It has also been renamed to JADUINST.EXE. (If you are upgrading from a previous version remember to delete the old JINSTALL.EXE to avoid confusion.) -> Added the <Tab> key as a speedy way to switch drives. Press <Tab> then the letter of the drive you want to go to. -> The <C>opy command now checks to see if there's enough room on the destination drive prior to the copy. If there isn't you are informed and given the chance to abort or continue (in case you know you will be over-writing files). If the destination is a floppy you are also given the option of formatting a new disk. -> Added <F8> as the format key. The utility you want to use to format disks is specified using the install program. -> You can now specify a command 'tail' for your utilities. This comes in handy for those utilities that require command lines switches be placed after the target files. -> You can now specify a destination directory with the mouse for copy, move, and archive extract. -> The JADUREG variable is no longer necessary to disable the beg screen (if you're a registered user, of course) -> You can now break out of operations on tagged files. Simply press the <Esc> key and JADU will ask if you want to abort. Please note that this will only work when JADU has control, so if you try to abort while using a utility that accepts multiple files you may have to wait a bit. -> JADU now will prompt for a new mask if the 500 file limit is hit. ---------------------------------------------------------------------- V E R S I O N 1 . 4 ---------------------------------------------------------------------- -> The [Scroll] or [Num] displayed on the bottom of the screen wasn't being displayed on return from DOS or user commands. Fixed. -> Fixed a nasty little bug which caused the configuration file not to be found if it resided in the root directory. -> Fixed a bug that didn't allow user defined commands without macros (i.e. "DIR {F}" was ok, but plain "DIR" wouldn't work). -> Added the Alt-T command to toggle the display of the current date and time on the bottom line of the screen. You can set time display to be on by default by setting a flag in the configuration file. See CHANGES.CNF for more information. Page 29 -> Fixed a bug in the "remain as is" configuration option for num lock and scroll lock. ---------------------------------------------------------------------- V E R S I O N 1 . 3 ---------------------------------------------------------------------- -> Fixed some annoying 'features' in the input routine. First, JADU will no longer remember that you went into insert mode (ie. you will always begin in overstrike mode). Second, the <End> key now places the cursor at the end of what you have typed - not at the end of the input field. Last, if you begin to type over an existing item (such as the default directory in copy or move operations) the remainder of the line will be blanked out (no more pressing the space bar). -> Made the utilities section of the configuration file case insensitive, thereby allowing lowercase command switches. -> Fixed a bug in the utilities section of the configuration file that disallowed the use of batch files and didn't allow the use of command switches with certain utilities. -> Usage of the <Home> and <End> keys in the entry of a destination directory (copy and move commands) has been changed. Previously these keys moved the pointer on the directory tree. They now act as editing keys, moving the cursor to the beginning and end of the information being entered. -> The number of files displayed in the status area no longer counts directories or the volume label. Only 'true' files are included. In the same vein, the tag command no longer tags directories or the volume label. -> JADU will now pass '*.*' to your utilities if you have marked them as accepting multiple files and all of the files in the current directory are tagged. For example, if there are 10 files in the current directory, you only have 9 tagged, and you wish to edit them with an editor that accepts multiple files on the command line, JADU will (probably) make 2 invocations of the editor to achieve this end. If all 10 were tagged then only one pass would be needed (EDIT *.*). This is especially handy when you want to archive an entire directory of files. -> Fixed the pause option in the utility section of the configuration file. (Please note that prior to this version the Archive View command paused no matter how this parameter was set. If you still wish JADU to do this you must make sure that the parameter is set correctly.) -> Added <ALT-X> and <ALT-Q> commands which exit and quit without waiting for confirmation. Page 30 -> The directory deletion routine was rewritten to make it a bit smarter. This should reduce the odds of getting a "deletion not completed" message if the directory tree gets out of sync with reality. -> Added automatic discovery of new directories. Prior to this version if you created a directory outside of JADU (with the MD command, for example) it would not show on the directory tree, thus creating confusion. Now JADU checks each directory found while loading the files area to see if it exists in the directory tree. If it does not exist the tree is updated. -> Added the ability to specify a destination directory for files extracted from archives. This eliminates the need to first copy an archive into the destination directory before decompressing the files. This feature uses the same interface as the copy and move commands (point to the directory and hit <Enter>). -> Added the <ALT-I> command to display the version timestamp. ---------------------------------------------------------------------- V E R S I O N 1 . 2 ---------------------------------------------------------------------- -> Fixed bug where JADU tied up all the room remaining on a disk if a copy or move bombed due to insufficient disk space (you then had to do a 'chkdsk /f' to free the space) -> Changed directory tree double lines to single lines to provide a bit more separation from the window border. -> Fixed bug that made JADU hang on systems running DOS version less than 3.0 which did not have a mouse. -> Tweaked and twiddled some internal code. ---------------------------------------------------------------------- V E R S I O N 1 . 1 ---------------------------------------------------------------------- -> Fixed bug in which the deletion of the current directory was attempted. You will now move to the parent of the you are trying to delete and the deletion will be allowed. -> Tagged files now remain tagged if you rename them -> Version 1.0's docs incorrectly stated that the maximum number of directories allowed was 150 (actually it was 100). The limit is now 150. -> JADU no longer converts DOS commands to uppercase, thus allowing case sensitive switches to be used. -> Fixed a bug which disallowed the use of an external file finder. Now allowed (as it should have been all along). Page 31 -> Fixed bug where JADU went through the motions of allowing you to rename the root directory -> Added the new command pdate to reload all directory information. This allows the easy changing of disks in floppy drives, if nothing else (IE. you no longer have to use the <N>ew path command when changing floppies, just hit 'U') -> Fixed bug where copied files received the current date, not the date of the original file. -> Removed check for '.ARC' file extension in ARC commands. You can now use any compression/extraction/library utility you want. -> The keyboard buffer is no longer cleared on startup, so typeahead is now possible while you're waiting for the directory/file scan to complete. -> The BIOS read/write option no longer exists. It was of doubtful use to begin with, was extremely slow and annoying to use, and (most of all) I needed the room. Needless to say, the F8 command has gone the way of the dinosaur. So has the BIOS/DMA field in the configuration file (see CHANGES.CNF). -> Flicker prevention can only be specified in the configuration file now (i.e. F7 will no longer toggle the option). -> JADU now allows the use of any print utility. An additional line has been added to the configuration file for this purpose. If you wish to continue using DOS Print you must specify it on this line (see CHANGES.CNF) -> Fixed bug in which the Print Tree and Print Directory commands occasionally did not print the last few lines until the next print command. -> The file name display has been changed to look like the DOS DIR display (i.e. the extensions line up) -> The single dot and double dot directory entries have been replaced with '<current>' and '<parent>'. -> The '0K' file size has confused many people. To avoid confusion only those files that actually contain 0 bytes are now marked as '0K'. Files where the size rounds to zero are marked '1K'. All others are marked with their true rounded size. -> Added feature in which JADU will retain a data file containing the directory tree information. This file will be kept only if the environmental variable JADUDIR has been defined. (You can use the new pdate command to reload all directory information if the data file gets out of sync). USERS OF VERSION 1.0 PLEASE NOTE THIS CHANGE IN THE USE OF 'JADUDIR'. IF YOU WERE USING 'JADUDIR' TO TELL JADU WHERE TO FIND THE CONFIGURATION FILE AND Page 32 DO NOT WANT TO SAVE THE TREE INFORMATION YOU MUST REMOVE THE 'SET JADUDIR' LINE FROM YOUR AUTOEXEC FILE AND MOVE THE CONFIGURATION FILE TO A DIRECTORY POINTED TO BY THE 'PATH' VARIABLE. SEE 'Starting JADU' FOR DETAILS. -> nfo command shortened to make a little more room. -> Added Refresh screen command (F7). I know it's not a mnemonic but the only other command I could think of was <K>lean screen. <Yuk!> Any suggestions are appreciated. -> Added <Q>uit option to the <F>ind command -> You can now specify that Scroll Lock and Num Lock be left alone when JADU is started. Simply use a '2' instead of '0' (off) or '1' (on) in the configuration file. Page 33 ---------------------------------------------------------------------- I N D E X ---------------------------------------------------------------------- <F1> 14 Date & time stamp 8 <F2> 16 Date/Time functions 12 <F3> 10 Delete command 12 <F4> 12 DESQview and JADU 18 <F5> 9 Directory tree 6 <F6> 10 DOS Commands 13 <F7> 16 Edit command 13 <F8> 14 Enter 10 <F9> 12 'Execute' command 10, 13 <F10> 12 Exiting JADU 13 Archive Functions 11 File Attributes, changing 14 Attributes 7 File list 7 Backslash 9 File name 7 Bug fixes 28 File selection mask 4, 15 Changing directories 7, 10 File size 7 Commands Find File command 14 Archive functions 11 Force BIOS 20 changing file attributes 14 Force monochrome 20 copy 11 Format Disk command 14 create directory 12 Help 14 date/time functions 12 Home/End 9 delete 12 Installation 3 DOS commands 13 JADUDIR 3 edit 13 JADUINST 3, 20 'execute' 13 Jump to DOS 13 exit 13 Keyboard 14, 16 find file 14 enter 10 format 14 home/end 9 help 14 keypad minus 9 list/view 14 keypad plus 9 move 15 left/right arrows 9 new path/mask 15 PgUp/PgDn 9 print 15 scroll lock 10 refresh screen 16 space 10 rename 16 up/down arrows 9 sort 16 Keypad minus 9 tag activation 16 Keypad plus 9 update 17 Left/Right arrows 9 wildcard tag 17 List/View command 14 Concept behind JADU 1 Macros 21 Configuration Modifications 28 exit 22 Move command 15 preferences 20 Movement/Action keys 9 screen colors 20 New Path/Mask command 15 user commands 21 PgUp/PgDn 9 utilities 21 Preferences 20 write file 21 Print command 15 Configuration file 3, 23 Refresh screen 16 Copy command 11 Registration 1 Create Directory 12 Rename command 16 Customize 20 Revision History 27 Data structures 24 Screen colors 20 Page 34 Scroll Lock 10 Sort command 16 Space 10 Starting JADU 3 Status area 6 Switches 4, 20 Syntax 4, 20 Tag option 16 Touching a File 12 Up/Down arrows 9 Update command 17 User Commands 21 Utilities 21 Wildcard Tag command 17 Page 35